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This  document  is  one  of  a  series  of  TM-891  volumes  established  for  Utility- 
System  program  specifications. 

Comments  on  this  document  must  be  received  by  25  April  1963  to  be  reflected 
in  the  final  design  criteria.  It  is  anticipated  that  this  feature  will  be 
available  in  the  AF/CPL  on  1  May  I963  •  The  publication  of  a  volume  in  the 
TM-705  (Systems  Manual)  series  will  officially  announce  the  completion  of 
this  project. 


Master  Tape  Control  II  (MTCII),  Mod  AG 

The  purpose  of  this  document  is  to  describe  the  new  features  which  will  be 
available  in  the  next  mod  of  the  COPII  control  program,  MTCII  mod  AG. 


The  anticipated  release  date  for  the  checked  out  program  and  the  documentation 
is  1  May  1963.  The  documentation  for  mod  AG  will  consist  of  a  supplement  to 
TM-7^5  and  a  milestone  7  (operating  procedures). 


The  features  which  warrant  a  new  mod  of  MTCII  are  as  follows : 


A.  Parameter  Test  Interface 


The  Parameter  Test  System  consists  of  three  separate  programs: 

1.  Reference  Pool  Simulator  (SRPS) 

2.  Test  Control  Program  (STCP) 

3.  Data  Reduction  Program  (SDRP) 

The  SRPS  and  SDRP  programs  are  called  via  a  normal  function  request  card, 
but  STCP  must  be  called  via  the  *STCP  pseudo  function.  The  foxmat  of  this 
pseudo  is: 


STCP 


¥ 


O 


UHIT 
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where:  STCP  is  the  name  of  the  parameter  test  pseudo,  and 

UNIT  is  the  logical  unit  number  on  which  the  traces,  recordings, 
etc.  will  be  made  by  the  Test  Control  Program  (STOP). 

Upon  encountering  the  STCP  pseudo,  MTCII  will  store  the  logical  unit  number 
from  the  request  into  the  cell  called  STCPUNIT  which  is  then  referenced 
symbolically  by  STCP.  A  flag,  STCPFLAG,  internal  to  MTCII,  will  be  set 
so  that  the  next  function  request  to  be  processed  will  result  in  the 
loading  of  the  Test  Control  Program  and  execution  of  it. 

The  deck  set  up  for  initializing  the  parameter  test  mode  is: 

*  STCP  UNIT 

*  FUNCTION 
STCP  Control  Cards 

where  FUNCTION  is  the  element  to  be  tested. 

The  restrictions  imposed  by  MTCII  on  the  functions  that  may  utilize  the 
parameter  test  system  are: 

1.  The  function  to  be  tested  and  its  environment  must  not  exceed  60000B 
cells  in  length. 

2.  The  ABDROF  or  the  Successor  Function  (CALL)  feature  of  MTCII  can  not 
be  utilized  either  by  the  function  to  be  tested  or  its  environment 
since  the  Test  Control  Program  occupies  the  area  above  70000B  and  the 
MTCII  code  which  processes  the  above  features  is  not  in  core.  The 
error  message  output  by  MTCII,  if  this  restriction  is  violated,  is  one 
of  the  following: 

a.  ABDROF  REQUESTED  DURING  PTS  MODE 

b.  SUCCFUN  REQUESTED  DURING  PTS  MODE 
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B.  Load  and  Go 


The  "Load  and  Go"  feature  provides  a  method  of  defining  a  program  from  the 
binary  punch  tape  output  by  LARII  or  from  a  prestored  binary  tape.  By 
utilizing  this  feature  a  program  can  be  assembled  and  tested  in  one  run. 

In  addition,  there  will  be  no  need  for  punching  binary  cards  since  the 
binary  tape  can  be  reserved. 


The  usage  of  this  feature  is  actuated  through  the  DEFINES  card  as  illustrated 
below: 


where: 


*  CARDS 

DEFINES  Px  P2  P3  P^  P5 
Correctors  if  P^  *  C  (optional) 

#P1 

name  of  function  to  be  defined. 

(optional)  is  equal  to  "F"  if  the  function  is  in  absolute 
binary  format;  otherwise,  Pg  is  not  present  and  the 
function  is  assumed  to  be  relocatable. 


?3  -  is  the  range  in  octal  of  a  relocatable  function  or  the 

octal  starting  location  of  an  absolute  function.  P^  is 
assumed  to  be  octal.  A  "B"  may  follow  P^  since  all  other 
octal  numbers  are  suffixed  by  B.  Prior  to  mod  AG  of  MTCII 
a  B  after  P^  was  illegal. 

P^  -  (optional)  is  the  logical  unit  number  on  which  the  binary 
deck  of  the  function  is  contained.  If  does  not  exist 
MTCII  will  assume  the  binary  deck  to  be  from  the  standard 
input  source  (cards  or  prestored  function  request  tape). 

Pj  -  (optional)  is  equal  to  "C"  if  correctors  are  to  be  input 
from  the  standard  input  source  (cards  or  prestored  func¬ 
tion  request  tape).  The  correctors  must  be  terminated 
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by  a  term  card.  The  card  following  the  term  card  or 
the  next  card  if  does  not  exist,  must  be  either 
another  EEFINES,  a  CORRECT  or  a  function  request. 
is  not  interrogated  if  P^  is  missing. 

If  P^  exists,  MTCII  will  rewind  the  specified  tape  and  then  interrogate 
the  third  word  of  the  first  record  of  each  file  (IEENT  record).  This 
word  of  the  IEENT  card  must  be  identical  to  the  BCD  name  of  the  function 
(p^)  taken  from  the  EEFINES  card.  If  the  function  is  not  found  the  fol¬ 
lowing  message  will  be  printed: 

FUNCTION  NOT  ON  LARII  BINARY  TAPE 

If  the  function  is  found  on  the  tape,  it  will  be  loaded.  If  correctors 
are  specified  by  P<_ ,  they  will  be  read  from  the  standard  input  source. 

The  "Load  and  Go"  feature  is  not  recommended  for  initial  assemblies.  An 
illustration  of  the  usage  of  "Load  and  Go"  is  as  follows: 

♦LARII  Assemble  program.  The  binary  output  is 

on  Unit  6. 

♦HALT  READY  UNIT  6  Instructions  to  the  operator  to  ready  the 

binary  punch  tape.  (Optional) 

♦CARDS 

EEFINES  FUNCTION  7000  6  C 
Correctors  followed  by  Term  Card 
♦FUNCTION 

If  there  are  no  correctors  for  the  function,  "C"  will  not  be  on  the 
EEFINES  card. 


i 


1  April  1963 


-5- 


TM-891/005/00 


C.  BCD  Sentence  Count 

A  new  type  of  field  was  added  to  free  field  correctors,  free  field  data 
cards  and  function  requests  in  mod  AF  of  MTCII.  This  field  provides  for 
hollerith  information  which  either  begins  with  a  number,  blank  or  arith¬ 
metic  symbol,  has  embedded  blanks,  or  consists  of  more  than  eight  characters. 
All  information  enclosed  in  parentheses  is  considered  to  be  a  BCD  sentence. 

Although  a  sentence  is  considered  to  be  one  parameter,  it  may  consist  of 
more  than  one  word  of  hollerith  information.  A  parameter  type  table  is 
output  by  FFCONV  when  converting  a  free  field  data  card  and  by  MTCII  when 
interpreting  a  function  request.  To  keep  the  number  of  words  in  the  para¬ 
meter  type  table  equivalent  to  the  number  of  words  of  converted  data,  there 
is  one  word  in  the  parameter  type  table  for  each  word  of  a  BCD  sentence. 

To  indicate  the  number  of  words  in  this  type  of  field,  a  new  entry  has  been 
added  to  the  parameter  type  table,  the  BCD  sentence  count. 

To  illustrate  this  type  of  field,  assume  the  following  request: 

*  STOP  (TEST  a CONTROL  a (STOP) )  1.  01 

where  a  indicates  a  space. 

The  information  on  this  request  will  be  interpreted  as  follows: 


Parameters 

Parameter  Type  Thble 

Word  1 

TEST /\ CON 

000  00003  000  00004 

2 

TOOL  A (ST 

000  00000  000  00004 

3 

CP)A  A  AAA 

000  00000  000  00004 

4 

2001400000000000 

000  00000  000  00001 

5 

0000000000000001 

000  00000  000  00002 
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The  upper  address  of  the  first  word  of  the  parameter  type  table  gives  the 
number  of  words  in  the  sentence  (3).  The  lower  address  of  each  word  is  the 
parameter  type  code  which  is  4  for  a  BCD  sentence,  3  for  an  octal  number, 

2  for  fixed  point,  1  for  floating  point  and  0  for  BCD. 

A  closed  parenthesis,  ),  followed  by  a  blank  terminates  the  BCD  sentence; 
therefore,  parentheses  may  be  enclosed  in  parentheses  provided  a  blank  does 
not  follow  a  ).  The  enclosed  parentheses  will  be  converted  to  their 
Hollerith  codes. 

D.  MTCII  Correctors 

Previously  correctors  for  MTCII  were  stored  dynamically  but  were  not  stored 
in  the  corrector  table.  Upon  a  re -load  of  MTCII,  the  correctors  were  not 
preserved.  In  mod  AG, MTCII  correctors  are  stored  in  the  corrector  table 
as  well  as  being  stored  dynamically.  Whenever  MTCII  is  re-loaded  the  cor¬ 
rector  table  is  interrogated  for  any  correctors  that  are  necessary  and  they 
are  stored  at  this  time.  . 

E.  MTCII  Mod  Number 

Whenever  auto-load  is  depressed  or  MTCII  is  re-loaded  a  message  indicative 
of  the  mod  of  MTCII  will  be  output  on  the  printer  and  the  system  output 
unit.  This  message  will  serve  to  identify  the  mod  of  the  control  program 
being  used  and  will  be  useful  in  trouble  shooting  when  numerous  versions 
of  it  are  being  used. 

The  messages  are:  . 

MTCII  XX  HAS  BEEN  RELOADED 
or  MTCII  XX  HAS  BEEN  AUTO  LOADED 
where  XX  is  the  mod  number  of  the  program. 


1  April  1963 


■7' 


TM-891/005/00 


F.  Intercommunication 

The  definition  of  elements  has  been  expanded  to  allow  intercommunication 
between  elements  whose  names  appear  in  the  CODES  table  but  do  not  exist 
in  the  directory.  Previously  the  message,  "ROUTINE  REQUESTED  WHICH  IS  NOT 
IN  THE  DIRECTORY",  was  output  when  elements  in  the  COEES  table  tried  to 
communicate  when  one  or  both  of  them  did  not  appear  in  the  directory. 

In  mod  AG  the  COEES  table  will  be  loaded  whenever  elements  are  defined. 

In  this  way  this  table  will  be  searched  prior  to  searching  the  directory. 
Additional  information  will  be  kept  in  EQUIVS  for  the  defined  element, 
i.e.,  its  COEES  number. 

G.  Typewriter  i/o  Routine 

A  new  typewriter  i/o  routine  will  be  incorporated  in  MTCII,  AG.  This 
routine  will  use  the  communication  informational  words,  I0STATUS,  EXITSTAT, 
and  IOBUFWD  as  described  in  FN-6950,  Proposal  for  New  i/o  Routines  in  MTCII. 

1 .  Input 

The  input  routine  for  the  typewriter  will  either  convert  the  typewriter 
code  to  hollerith  and  pack  the  characters  8  per  word,  pack  the  type¬ 
writer  code  8  per  word  with  the  upper  and  lower  cases  inserted  or  out¬ 
put  the  typewriter  code  one  character  per  word  with  upper  and  lower 
cases  inserted  depending  upon  the  setting  of  IOSTATUS.  The  typewriter 
routine  will  automatically  carriage  return  and  shift  to  lower  case.  A 
carriage  return  or  number  of  words  specified  will  terminate  input.  If 
an  error  is  made  in  typing,  a  colon  or  semi-colon  will  result  in  the 
clearing  of  the  output  image,  a  carriage  return  and  a  shift  to  lower 
case.  The  input  image  will  be  filled  up  with  blanks  or  spaces  if  less 
words  are  input  than  are  requested. 
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2 .  Output 

The  typewriter  will  be  carriage  returned  and  shifted  to  lower  case. 
Depending  upon  the  IOSTATUS  word  the  data  will  be  either  converted 
from  BCD  code  to  typewriter  code,  typed  in  assembly  mode  or  character 
mode.  Illegal  BCD  characters  will  be  replaced  by  the  typewriter  code 
for  colon  or  semi-colon  depending  upon  the  case. 

H.  Interrupt 

The  16OA  interrupt  will  be  processed  in  a  slightly  different  fashion. 
Whenever  MTCII  cannot  be  interrupted,  the  l6o?  communication  flag  1  will 
be  set.  The  16OA  will  be  modified  so  that  it  will  not  initiate  an  inter¬ 
rupt  when  the  flag  is  set.  MTCII  will  clear  flag  1  and  delay  at  least  4 
seconds  whenever  interrupt  is  feasible.  Interrupt  will  be  permitted  only 
between  the  execution  of  two  functions.  When  interrupted  by  the  160A, 
MTCII  will  determine  whether  SBRDTIJC  is  already  in  core.  If  it  is  not,  it 
is  loaded.  The  message,  "THE  TRANSMIT  MOTE  IS  BEGINNING",  will  be  typed 
and  then  SBRDTLK  will  be  operated.  After  its  execution  MTCII  will  type 
"THE  TRANSMIT  MODE  IS  TERMINATED" .  l60?  communication  flag  1  is  still 

used  to  acknowledge  the  16OA  interrupt.  All  previous  messages  and  usage 
of  Jump  key  two  will  be  deleted. 

I .  Timing  Routine 

The  purpose  of  the  timing  routine  will  be  to  time  a  portion  of  a  function, 
an  entire  function,  a  function  including  the  loading  time,  or  a  group  of 
functions.  The  timing  element,  which  will  be  an  integral  part  of  MTCII, 
may  be  called  either  by  a  function  request  or  by  utilizing  it  as  a  sub¬ 
routine  . 

1.  Function  Request  Usage 

The  format  of  the  timing  pseudo  function  will  be: 
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*  CLCK  P  Pg  P3 

where:  P^  =  ON  clears  the  clock  counter  and  activates  the  clock 
depending  upon  the  P^  parameter. 

P1  =  OFF  stops  the  clock  and  results  in  the  output  of  the 
total  elapsed  time  for  the  period  when  the  clock 
was  activated  until  the  CLCK  OFF  request  was  en¬ 
countered. 

P2  *  (optional)  the  unit  number  of  the  output  of 

elapsed  times.  If  no  unit  is  specified,  output 
will  be  on  the  1612  printer. 

P^  «■  (optional)  If  is  omitted  the  elapsed  time 
for  the  ON-OFF  period  will  be  output. 

P^  «  F  indicates  that  the  elapsed  time  for  each  function 
will  be  output  in  addition  to  the  total  elapsed 
time.  The  time  for  the  function  will  be  its  exe¬ 
cution  time. 

=  L  indicates  that  the  elapsed  time  for  each  function 
including  the  time  to  load  and  process  the  function 
will  be  output  in  addition  to  the  total  elapsed 
time. 


2.  CLCK  Subroutine  Usage 

The  usage  of  CLCK  as  a  subroutine  will  permit  the  timing  of  a  portion 
of  a  function.  The  calling  sequence  will  be: 

B  RTJ  CLCK 
B+l  P1 
B+2  P2 

B+3  Normal  Return 


f 
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where:  =  ON  or  OFF  as  explained  in  the  function  request  usage 

of  CLCK 

P2  =  logical  unit  number  of  the  output  of  elapsed  time 

CLCK  is  a  symbol  in  the  RST  table;  therefore,  it  may  be 
referenced. 

3 •  Output 

There  are  four  types  of  output:  Elapsed  time  of  individual  functions, 
total  elapsed  time  for  a  sequence,  time  for  a  function  including  load 
time  and  the  time  required  for  a  portion  of  a  function.  The  output 
will  be  on  the  specified  unit: 

2-12  and  16-19  -  magnetic  tape  units 

13  -  printer 

14  -  typewriter 


The  messages  will  be: 

a.  E.  T.  FOR  FUNCTION  -  HR: MIN: :SEC.SEC/lOO 

b.  E.  T.  FOR  FUNCTION  INCL.  L.  T.  »  HR  MIN  SEC. SBC/lOO 

c.  TOTAL  E.  T.  FOR  SEQUENCE  -  HR  MIN  SEC. SBC/lOO 

d.  E.  T.  FOR  PART  OF  FUNCTION  «*  HR  MOT  SEC.SEC/lOO 

where:  E.  T.  -  elapsed  time 

L.  T.  -  is  time  required  to  process  function  request  and  load 
the  elements  from  the  Master  Tape. 

Messages  c  or  d  will  be  output  when  CLCK  OFF  is  encountered.  Messages 
a  and  b  will  be  output  after  the  execution  of  each  individual  function, 
if  so  specified. 
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b.  Restrictions 

a.  Functions  presently  using  the  clock  for  timing  or  interrupt  pur¬ 
poses  should  be  modified  to  eliminate  the  usage  of  the  clock. 

There  are  two  reasons  for  this  request;  one  is  that  it  limits  the 
usage  of  the  timing  pseudo  and  two,  the  inactivity  feature  of  the 
Parameter  Test  System  can  not  be  utilized. 

b.  If  CLCK  ON  is  encountered  when  the  clock  has  already  been  acti¬ 
vated,  the  previous  selection  will  be  discontinued  and  the  clock 
counter  will  be  cleared. 

J.  Usage  of  Clank 

The  usage  of  CLANK  will  be  permitted  as  an  N,  parameter  on  a  function  re¬ 
quest,  and  as  a  parameter  on  a  CLR  or  CARDS  card. 

1.  Function  Request 

When  CLANK  is  encountered  as  an  parameter  on  a  function  request,  the 
system  will  not  be  initialized,  the  last  function  processed  will  not 
be  erased  from  core,  the  Special  Operating  Mode  will  not  be  terminated 
and  the  environment  of  the  next  function  will  start  at  the  location 
specified  by  CLANK  (current  location  counter).  An  example  of  the  usage 
of  CLAlfC  on  a  function  request  is  as  follows; 

*  CLANK  DUMP  3  10000B  20000B 

This  request  will  enable  the  dumping  of  core  without  initializing  core 
or  wiping  out  the  area  of  interest.  This  capability  will  be  useful 
when  operating  in  the  Special  Operating  Mode. 

2.  CLR 

CLANK  can  be  used  to  specify  the  starting  location  of  the  area  to  be 
cleared.  Everything  previously  in  core  will  be  retained  and  the  area 
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from  CLAMK  to  the  end  of  usable  core  (70000B  in  case  of  CLR)  will  be 
set  to  zeros.  The  Special  Operating  Mode  will  not  be  terminated. 

An  example  is: 

*  CLR  C  CLAMK  65OOOB 


3.  CARDS 

When  CLANK  is  input  on  the  CARDS  pseudo  request,  the  first  defined 
function  will  be  loaded  following  the  last  element  in  core.  The 
system  will  not  be  initialized  in  this  case;  however,  it  is  the  user's 
responsibility  to  save  enough  room  in  core  for  the  defined  element, 
otherwise  an  error  halt  will  occur  (defined  elements  can  not  go  above 
700C '  3  in  core).  The  following  illustrates  the  use  of  CLAMK: 

*  CARDS  CLAMK 
DEFINES  A  10000 
Deck  of  A 

*  A 

If  already  in  the  Special  Operating  Mode,  the  mode  will  not  be  ter¬ 
minated. 

K.  Length  of  Redefined  Element 

Whenever  a  redefined  element  is  loaded,  its  new  length  from  the  DEFINES 
card  will  replace  its  length  in  the  directory.  As  long  as  the  element 
remains  in  core,  its  new  length  will  be  retained.  This  will  result  in 
the  correct  length  being  used  by  SYMDUMP  since  it  used  tables  built  by 
MTCII  to  obtain  an  element's  length  and  starting  location. 

Whenever  core  is  effectively  cleared  (that  is,  the  tables  acknowledging 
the  contents  of  core  sure  cleared),  the  directory  will  be  re -loaded,  so  that 
if  the  element  is  requested  from  tape,  the  correct  length  will  be  used. 
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L.  Successor  Call 

To  provide  for  interface  between  SCHOPS  and  MTCII,  the  successor  call 
capability  has  been  expanded  to  allow  pseudo  functions  to  be  requested, 
to  offer  the  option  of  not  initializing  the  core  allocation  tables,  and 
to  provide  a  "Do  not  Operate"  option. 

The  expanded  successor  call  feature  has  the  following  calling  sequence: 

Step  1  -  Enter  the  Accumulator  with  the  BC1  name  for  the  desired 

function. 


0 


Step  2  -  Enter  Q  with  the  control  information.  The  format  of  Q  is: 


47  46  45  44  43  42  38 - 24  14 - 0  Bit 


where:  A  (bit  47)  ■  0  Return  control  to  MTCII 

=  1  Return  control  to  object  program 

B  (bit  46)  ■  0  Bo  B^  parameter 

»  1  B^  is  present  in  calling  sequence.  is  the 
storage  analysis  unit. 

C  (bit  45)  ■  0  Bo  Ng  parameter 

■  1  Bg  is  present.  Bg  is  the  number  of  arithmetic 
interrupt  messages  to  output.  If  Bg  is  zero, 
interrupt  on  arithmetic  fault  will  not  be  se¬ 
lected. 


D  (bit  44)  ■  0  Bo  B^  parameter 

■  1  is  present  and  is  the  starting  location 
desired  for  the  function  requested. 
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E  (bit  43)  =  0  No  N^  parameter 

=1  N^  is  present  and  is  equal  to  "X"  to  indicate 
to  load  the  requested  function  but  do  not 
operate  it. 


F  (bit  1+2)  =  0 
=  1 

G  (bits  24.38) 
H  (bits  0-14) 


Initialize  core  allocation  tables 
Do  not  initialize 

Number  of  parameters  in  calling  sequence. 
Number  of  mods  in  calling  sequence. 


Step  3  -  Execute  the  following  calling  sequence: 

RTJ  CALL 


P 

P 

«1 

«2 


N.  Only  those  control  parameters  specified 

„  in  Q  can  follow  the  call.  If  A  is  set 

w2  to  1,  MTCII  will  return  control  to  the 

N,  next  location  following  the  calling  se- 

„  quence  (normal  return). 

N4 

Normal  Return 


All  programs  currently  using  successor  call  are  not  affected  unless 
the  operation  code  of  the  upper  instruction  contains  1  bits  instead 
of  zero. 


To  call  pseudos  via  successor  call,  the  parameters  for  the  pseudo  will 
have  to  be  included  in  the  call  for  it. 


1  April  1963 
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